********************************************************

  /----------\
 |  _________ |
 |            |-- ______ _    ___    _
 |---------   |  |__   _|  \ / _ \ / _|
 |            |    _| |_  - |  ___| |
  \----------/----|_____|__/ \____|_|   PSP


********************************************************

Version:1.0
Author:	[mEo!]
Date:	12/07/2006
Website:http://www.meosoft.net

Special Thanks: LUA PSP Team
		LUA Player Developers



INTRODUCTION
------------

Slider PSP is a panel sliding style game, where you have to
put each square in numerical order.


KNOWN BUGS
----------

1.  Failed to index '?'
	This bug is caused when you have entered more columns
	and rows than you have images for.  For example, if
	you have 7 rows and 20 columns, but only 99 images, or
	99 images loaded in the code, then this error will be
	produced.
	To fix, simply use the Slider Image Generator to make
	more images, and copy the outputted code into the top
	of index.lua, overwriting the old.

HOW TO PLAY
-----------

Using the directional arrows, move the blank square around,
moving other squares into a new position.  The aim is to get
all the squares in order. Starting from the top left, going
left to right, place then in numerical order.
eg.
  1  2  3  4
  5  6  7
Once they are all in order, you have completed the puzzle.
Note:  The blank square must finish in the bottom-right hand
corner.  This is also where the blank square starts.


CONTROLS
--------

In the Menu:
	X - Select
	Left and Right: Change a value
	Up and Down: Move between the menu options

In Game:
	There are two different control styles.  The style
	can be changed in the menu menu.
	Control Style 1:
		When a direction is pressed, the blank square
		will move in that direction.
		eg.
			5  6  7
			8     9
		If you press up in this example, the result
		would be:
			5     7
			8  6  9

	Control Style 2:
		When a direction is pressed, the square next
		to the blank square, in the opposite position
		to the direction pressed, will move into the
		blank space.
		eg.
			5  6  7
			8     9
		If you press up in this example, nothing would
		happen, as the square below the blank spot
		cannot move up, there is no square there.
		However, if you pushed down, the result would
		be:
			5     7
			8  6  9
		The square above the blank square can move
		DOWN.
	
		Control Style 2 may sound more complicated,
		but it is in fact how a real life slider
		puzzle would be controled.  If you can imagine
		such a puzzle, if you slid a piece up, filling
		the blank spot, you are pushing UP, moving the
		square BELOW the blank one.

		Control Style 2 is also the default style.


IMPOSSIBLE COMPLETION
---------------------

Unfortunatly, Slider PSP does not have an impossible scenario
evaluator.  Sometimes, puzzles that are generated cannot be
completed.

For example,
	1  3
	2

This 2*2 puzzle is impossible, because there is no way to swap
the position of the three and the two around.

If you come across a situation like this, I recommend giving
yourself a pat on the back, rather than tearing your hair out
trying to shift panels at random or puzzling over what could
be an impossible puzzle.  If you made it that far, you would
have completed it by then anyway :)


THE SLIDER PSP IMAGE GENERATOR
------------------------------

Everybody is different and prefer different styles.
In order to accomodate for this, Slider PSP comes with an easy
to use program that will generate a certain number of images,
with customizable styles.

The different options for the generator are:
	Font Color: The color the number will be
	Back Color: Background color of the picture
	Font: Name: The font the number will be in.
	      Size: Font size of the number
	      Bold / Italic / Underline: Self explanitory.
	Border Color: Optional.  Color of the border.
	Border Width: Thickness (in pixels).  If you do not
		      want a border, enter 0.
	Image H / W:  Height of each image.  The number
		      printed onto each image is not centered
		      and the picture is not resized if there
		      is overflow, so use image height and 
		      width to make sure everything is seen :)
	Max. Num: The number of images to be generated.  If 20
		  is entered, 20 images will be made, the
		  final one being '20'.
	Output Dir: Destination folder of the images.
	Add 0:  For numbers less than 0, if this is checked,
		a zero (0) will be added in front of the
		number (eg. 04)
	Rst. Default: Reset all settings to the defaults.
	Generate: Generate the images!


Once you have generated all the images, you will be shown a
text box, filled with LUA code.  If you have changed the
number of images you previously had, copy this text and
paste it in the top of 'index.lua', overwriting the existing
text that was generated by the Slider Image Generator.

Slider PSP will read images in '.\images' directory, according
to where the index.lua file is located.

Note:  This program requires Microsoft's GDI redistributable
package, which is available to download for free from the
Microsoft website.  Most users should have this on their
computer already.


FINAL NOTES
-----------

If you have any comments, suggestions or improvements that
can or could be made to the program, please feel free to
contact me at: mikesena@gmail.com, or visit my website at
http://www.meosoft.net (the new version is in development at
the time of completing Slider PSP)

For those who want to improve the Slider Image Generator, or
wish to see how it was made, I have included the source code
of the program.  It was made in Visual Basic 6 and uses
Microsoft's GDI.  This is available as a redistributable
package from Microsoft's website.